home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / workbench / libs / dignet_2_1.lha / dignet / debug / DignetDebug.doc next >
Text File  |  1997-03-12  |  2KB  |  57 lines
  1.  
  2. From 2.1 we included resource tracking into the dignet.library.
  3.  
  4. We have provided two tools here which can help, but you should use them at your
  5. own risk and they don't guarantee success when used.
  6.  
  7.  
  8. DignetLIST
  9. ----------
  10.  
  11. This command is just dumping all the nets in use or that have been allocated.
  12. If a program crashes or end without cleaning up the net it will be listed here.
  13.  
  14. The output could look like this:
  15.  
  16. No. 1 - Net: $777E040  Task: $77A41C8 (Dignet TERM) OK
  17. No. 2 - Net: $7401930  Task: $7400278 (EAN reader) ERROR
  18.  
  19. It means net number 1 at address (the net you give to a function).
  20. Task address which allocated it and the name of the task.
  21. Finally if OK the task still exists, if ERROR the task is gone.
  22.  
  23. This is where the resource tracking comes in.
  24.  
  25.  
  26. DignetKILL
  27. ----------
  28.  
  29. With this utility you can remove allocted memory, close device and abort IO
  30. request on programs that is dead. The program must have used the
  31. dignet.library of course.
  32.  
  33. When you find a program that says ERROR from the dump of DignetLIST you can
  34. take the number which is first on the line and use this program, f.ex:
  35.  
  36. DignetKILL 2
  37.  
  38. if it was the program shown above. You will then get prompted if you are
  39. sure, if yes, DignetKILL sends a break signal (mask $C000FFFF) to the program
  40. (if you choose to use it on a living task), then aborts the IO requests and
  41. finally frees the net structure, closes the device and clean up the resource
  42. list.
  43.  
  44. You CAN use this on a living task if the task locks up waiting for chars to
  45. be read on a port. You may experience that the system crashes if the program
  46. jumps to other functions afterwards.
  47.  
  48. It's however safe to call the FreeNet() function right after a Abort since
  49. the FreeNet() checks the resource list of the net's existance.
  50.  
  51. If the system lives you should be able to use the device again.
  52.  
  53.  
  54. DISCLAIMER:
  55.  
  56. You use these programs and the dignet.library extirely on your own risk!
  57.